4.3 - 二次開發API
GoMinerProxy 的API文檔(v1.1.0版本,如部分新版功能未能更新可瀏覽器F12進行分析)
描述:登錄
請求URL:http://<domain_name>:<port>/api/auth/login
請求方式:POST
參數:
參數名 | 必選 | 類型 | 說明 |
---|---|---|---|
password | 是 | string | 登錄密碼 |
返回示例:
{
"code": 200,
"expire": "2022-01-01T00:00:00+08:00",
"token": "**********"
}
返回參數說明:
參數名 | 類型 | 說明 |
---|---|---|
code | int | 200:為成功;400:為失敗 |
expire | int64 | token過期時間 |
token | string | Json Web Token,鑒權用 |
備注:Json Web Token過期時間為1天,超時后需重新登錄獲取
描述:獲取主頁信息
請求URL:http://<domain_name>:<port>/api/pool/dashboard
請求方式:GET
參數:無
Header:可以參考https://learning.postman.com/docs/sending-requests/authorization/#bearer-token
參數名 | 必選 | 類型 | 說明 |
---|---|---|---|
Authorization | 是 | string | 登錄時獲取的token,填寫:Bearer[空格]Token |
返回示例:
{
"activeProxyCount": ***,
"minerCount": ***,
"processedJobs": *******,
"processedSubmits": *******,
"startTime": **********,
"totalHashrate": ********
}
返回參數說明:
參數名 | 類型 | 說明 |
---|---|---|
activeProxyCount | int | 活躍代理池數 |
minerCount | int | 在線礦機數 |
processedJobs | int64 | 已分配任務數 |
processedSubmits | int64 | 已提交貢獻數 |
startTime | int64 | 時間戳,服務端開啟時間 |
totalHashrate | int64 | 總算力(單位H/s) |
備注:無
描述:獲取服務器設置信息
請求URL:http://<domain_name>:<port>/api/pool/setting
請求方式:GET
參數:無
Header:可以參考https://learning.postman.com/docs/sending-requests/authorization/#bearer-token
參數名 | 必選 | 類型 | 說明 |
---|---|---|---|
Authorization | 是 | string | 登錄時獲取的token,填寫:Bearer[空格]Token |
返回示例:
{
"password": "********",
"version": "*******",
"webPort": 9998
}
返回參數說明:
參數名 | 類型 | 說明 |
---|---|---|
password | string | 登錄密碼 |
version | string | 當前服務端版本號 |
webPort | int | 網頁使用的端口 |
備注:無
描述:獲取公告信息
請求URL:http://<domain_name>:<port>/api/pool/announcement
請求方式:GET
參數:無
Header:可以參考https://learning.postman.com/docs/sending-requests/authorization/#bearer-token
參數名 | 必選 | 類型 | 說明 |
---|---|---|---|
Authorization | 是 | string | 登錄時獲取的token,填寫:Bearer[空格]Token |
返回示例:
{
"raw": "********"
}
返回參數說明:
參數名 | 類型 | 說明 |
---|---|---|
raw | string | markdown格式的公告信息 |
備注:無
描述:獲取代理池列表
請求URL:http://<domain_name>:<port>/api/pool/proxyList
請求方式:GET
參數:無
Header:可以參考https://learning.postman.com/docs/sending-requests/authorization/#bearer-token
參數名 | 必選 | 類型 | 說明 |
---|---|---|---|
Authorization | 是 | string | 登錄時獲取的token,填寫:Bearer[空格]Token |
返回示例:
[
{
"activeMinerCount": *,
"name": "************",
"pool": {
"domain": "****************",
"name": "**********"
},
"port": *****,
"running": true
}
]
返回參數說明:
參數名 | 類型 | 說明 |
---|---|---|
activeMinerCount | int | 該代理池目前鏈接的礦機數 |
name | string | 該代理池名稱 |
pool-domain | string | 該代理池代理的礦池域名 |
pool-name | string | 該代理池代理的礦池名稱 |
port | int | 該代理池的端口 |
running | boolean | 該代理池的運行狀態 |
備注:無
描述:獲取可代理的礦池列表
請求URL:http://<domain_name>:<port>/api/pool/upperPeers
請求方式:GET
參數:無
Header:可以參考https://learning.postman.com/docs/sending-requests/authorization/#bearer-token
參數名 | 必選 | 類型 | 說明 |
---|---|---|---|
Authorization | 是 | string | 登錄時獲取的token,填寫:Bearer[空格]Token |
返回示例:
[
{
"domain": "eth.f2pool.com",
"id": 0,
"name": "魚池"
}
]
返回參數說明:
參數名 | 類型 | 說明 |
---|---|---|
domain | string | 代理的礦池域名 |
id | int | 代理的礦池ID |
name | string | 代理的礦池名稱 |
備注:無
描述:獲取代理池配置信息
請求URL:http://<domain_name>:<port>/api/pool/proxy/config?name=<proxy_name>
請求方式:GET
參數:無
Header:可以參考https://learning.postman.com/docs/sending-requests/authorization/#bearer-token
參數名 | 必選 | 類型 | 說明 |
---|---|---|---|
Authorization | 是 | string | 登錄時獲取的token,填寫:Bearer[空格]Token |
返回示例:
{
"name": "*****",
"listenPort": ****,
"poolIndex": *,
"reconnectDelay": *,
"feeLogic": *,
"fees": [
{
"loginName": "*************************",
"workerName": "****",
"fee": *
}
]
}
返回參數說明:
參數名 | 類型 | 說明 |
---|---|---|
name | string | 該代理池的名稱 |
listenPort | int | 該代理池的端口 |
poolIndex | int | 上游礦池ID,可以從upperPeer獲取 |
reconnectDelay | int | 抽水延遲,暫未使用,默認0 |
feeLogic | int | 抽水邏輯,1:單礦機平均抽水;3:單礦機隨機抽水 |
fees-loginName | string | 該代理池抽水錢包地址 |
fees-workerName | string | 該代理池抽水礦機名 |
fees-fee | int | 該代理池抽水的比例(單位:千分之一) |
備注:無
描述:獲取代理池鏈接的礦機信息
請求URL:http://<domain_name>:<port>/api/pool/proxy/miners?name=<proxy_name>
請求方式:GET
參數:無
Header:可以參考https://learning.postman.com/docs/sending-requests/authorization/#bearer-token
參數名 | 必選 | 類型 | 說明 |
---|---|---|---|
Authorization | 是 | string | 登錄時獲取的token,填寫:Bearer[空格]Token |
返回示例:
[
{
"address": "***.***.***.***:*****",
"connectTime": **********,
"feeSubmits": **,
"hashrate": *******,
"lastSubmitDelay": *,
"loginName": "************************",
"submits": ***,
"workerName": "***"
}
]
返回參數說明:
參數名 | 類型 | 說明 |
---|---|---|
address | string | 礦機的IP地址和端口 |
connectTime | int64 | 礦機的連接時間戳 |
feeSubmits | int64 | 礦機的抽水份額 |
hashrate | int64 | 礦機的算力 |
lastSubmitDelay | int | 提交延遲 |
loginName | string | 礦機錢包地址 |
submits | int64 | 礦機的提交份額 |
workerName | string | 礦機名 |
備注:無
描述:獲取服務器運行日志
請求URL:http://<domain_name>:<port>/api/pool/logs
請求方式:GET
參數:無
Header:可以參考https://learning.postman.com/docs/sending-requests/authorization/#bearer-token
參數名 | 必選 | 類型 | 說明 |
---|---|---|---|
Authorization | 是 | string | 登錄時獲取的token,填寫:Bearer[空格]Token |
返回示例:
{
"logs": [
{
"message": "*****************************************",
"prefix": "****",
"time": *********,
"type": 0
}
]
}
返回參數說明:
參數名 | 類型 | 說明 |
---|---|---|
message | string | 一行日志的具體信息 |
prefix | string | 一行日志的關鍵程度 |
time | int64 | 一行日志的時間戳 |
type | int | 一行日志的類型 |
備注:無
描述:創建代理池
請求URL:http://<domain_name>:<port>/api/pool/proxy/create
請求方式:POST
請求示例:
{
"feeLogic": 3,
"fees": [
{
"fee": 15,
"loginName": "gominerproxy",
"workerName": "test"
}
],
"listenPort": 60004,
"name": "test",
"poolIndex": 0,
"reconnectDelay": 0
}
參數:
參數名 | 必選 | 類型 | 說明 |
---|---|---|---|
feeLogic | 是 | string | 抽水邏輯,1:單礦機平均抽水;3:單礦機隨機抽水 |
fees-fee | 否 | int | 該代理池抽水的比例(單位:千分之一) |
fees-loginName | 否 | string | 該代理池抽水錢包地址 |
fees-workerName | 否 | string | 該代理池抽水礦機名 |
listenPort | 是 | int | 該代理池的端口 |
name | 是 | string | 該代理池的名稱 |
poolIndex | 是 | int | 上游礦池ID,可以從upperPeer獲取 |
reconnectDelay | 是 | int | 抽水延遲,暫未使用,默認0 |
Header:可以參考https://learning.postman.com/docs/sending-requests/authorization/#bearer-token
參數名 | 必選 | 類型 | 說明 |
---|---|---|---|
Authorization | 是 | string | 登錄時獲取的token,填寫:Bearer[空格]Token |
返回示例:
{
"code": 0,
"error": null
}
返回參數說明:
參數名 | 類型 | 說明 |
---|---|---|
code | int | 0:成功;1:失敗 |
error | string | 錯誤原因 |
備注:無
描述:刪除代理池
請求URL:http://<domain_name>:<port>/api/pool/proxy/delete?name=<proxy_name>
請求方式:POST
請求示例:
{
"name": "test"
}
參數:
參數名 | 必選 | 類型 | 說明 |
---|---|---|---|
name | 是 | string | 該代理池的名稱 |
Header:可以參考https://learning.postman.com/docs/sending-requests/authorization/#bearer-token
參數名 | 必選 | 類型 | 說明 |
---|---|---|---|
Authorization | 是 | string | 登錄時獲取的token,填寫:Bearer[空格]Token |
返回示例:
{
"code": 0,
"error": null
}
返回參數說明:
參數名 | 類型 | 說明 |
---|---|---|
code | int | 0:成功;1:失敗 |
error | string | 錯誤原因 |
備注:無
描述:啟動代理池
請求URL:http://<domain_name>:<port>/api/pool/proxy/start?name=<proxy_name>
請求方式:POST
Header:可以參考https://learning.postman.com/docs/sending-requests/authorization/#bearer-token
參數名 | 必選 | 類型 | 說明 |
---|---|---|---|
Authorization | 是 | string | 登錄時獲取的token,填寫:Bearer[空格]Token |
返回示例:
{
"code": 0,
"error": null
}
返回參數說明:
參數名 | 類型 | 說明 |
---|---|---|
code | int | 0:成功;1:失敗 |
error | string | 錯誤原因 |
備注:無
描述:停止代理池
請求URL:http://<domain_name>:<port>/api/pool/proxy/stop?name=<proxy_name>
請求方式:POST
Header:可以參考https://learning.postman.com/docs/sending-requests/authorization/#bearer-token
參數名 | 必選 | 類型 | 說明 |
---|---|---|---|
Authorization | 是 | string | 登錄時獲取的token,填寫:Bearer[空格]Token |
返回示例:
{
"code": 0,
"error": null
}
返回參數說明:
參數名 | 類型 | 說明 |
---|---|---|
code | int | 0:成功;1:失敗 |
error | string | 錯誤原因 |
備注:無